Markdown 首要哲學與核心架構原則

OpenClaw 基礎

1. Markdown 首要哲學

OpenClaw 將人類可讀的文件視為絕對的真理來源。與將邏輯埋藏於資料庫的系統不同，代理的「靈魂」定義於文字檔案中，確保了透明性與簡單的版本控制。

SOUL.md： 定義角色與道德界線。
AGENTS.md： 概述工程工作流程。
MEMORY.md： 儲存長期事實與偏好。

2. 模型無關且自主

中央化的代理執行環境允許在不重寫邏輯的情況下切換 LLM（Claude、GPT、本地模型）。自主代理透過 HEARTBEAT.md 排程器全天候運作。

3. 可靠性與資料完整性

為防止在高併發環境中出現狀態損毀，OpenClaw 使用 會話隔離 透過通道佇列實現。資料檢索由 本地優先 RAG 架構透過語義快照處理。

設定：openclaw.json

{ "global": { "port": 18789, "identity": "./config/SOUL.md", "env_injection": true }, "security": { "firewall": "strict", "rce_protection": true } }

Type a command...

Question 1

Why does OpenClaw prioritize a "Markdown-First" approach?

To increase the execution speed of the LLM.

To ensure transparency and human-readability.

To replace the need for JSON files entirely.

Question 2

What prevents "State Corruption" during simultaneous user interactions?

Local-First RAG

Semantic Snapshots

Session Isolation via Lane Queues

Challenge: The Debugger

Diagnose the missing agent behavior.

Problem: An agent has been deployed, but it is responding with a generic personality instead of its assigned role, and it cannot recall data from yesterday's session.

Analysis

Which files or components are likely misconfigured?

Diagnosis:
1. Persona Issue: Check SOUL.md and ensure it is correctly referenced in openclaw.json.
2. Memory Issue: Ensure MEMORY.md is writable and the Local-First RAG system is successfully creating Semantic Snapshots.